home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_83 / readme.!!! < prev    next >
Text File  |  1995-01-01  |  16KB  |  279 lines
  1.             ╓───────────────────────────────────────────╖
  2. Contents of ║ S Y N Z A P 1 0 . Z I P                   ║
  3.    Archive: ║···········································║
  4.             ║ Synthe/Zap! Instrument Editor             ║
  5.             ║···········································║
  6.             ║ A program to create new instrumental      ║
  7.             ║ timbres and modify existing ones.  For    ║
  8.             ║ use with the Ad Lib* music synthesizer.   ║
  9.             ║···········································║
  10.             ║ Beta test release 1.00, 04-15-90          ║
  11.             ║ Copyright (C) 1990                        ║
  12.             ║ by J Meeks & Machina Sapiens              ║
  13.             ╙───────────────────────────────────────────╜
  14.  
  15. ───────────────────────────────────────────────────────────────────────────────
  16.  
  17. README.!!!     The text file you are reading now.
  18.  
  19. SZ.EXE         Executable program file to create new instrument sounds for the
  20.                Ad Lib music synthesizer, and to modify existing ones.  I think
  21.                you'll agree this program beats the Ad Lib Instrument Maker
  22.                hands down for functionality, features, appearance, and feel.
  23.  
  24.                This is a demonstration copy.  It has all the features of the
  25.                full version that registered users receive, except that it will
  26.                not save the instruments you have made.  If you send in the
  27.                shareware registration fee (see below), I will send you the
  28.                latest version of the full-featured program.
  29.  
  30.                To run Synthe/Zap! you must have the following:
  31.  
  32.                      An IBM PC* compatible computer, the faster the better
  33.                     An EGA* or VGA* display with at least 256k of RAM
  34.                    A monitor able to display the EGA's 640x350, 16-color mode
  35.                   A Microsoft or compatible mouse and its driver program
  36.                  An Ad Lib music synthesizer and its sound driver program
  37.  
  38.                Both the mouse drifver and the sound driver must be installed in
  39.                memory before the Synthe/Zap! program is run!  If the mouse
  40.                driver is missing, just about all you'll be able to do is quit
  41.                (use the Esc key).  If the sound driver hasn't been loaded, your
  42.                computer will very likely lock up, forcing you to turn the power
  43.                off or hit the reset switch to reboot.
  44.  
  45.                Copy this and all the other files into one subdirectory, change
  46.                the active directory to that one, then run this program.  Try
  47.                playing around with various controls, then see how the notes
  48.                sound.  Read SYNZAP10.TXT for more complete instructions on how
  49.                to operate Synthe/Zap!
  50.  
  51.                Have fun!  Please tell me what you think, as that's the only way
  52.                the program will act the way YOU like!  I will try to mention
  53.                all contributors to the program in the documentation.
  54.  
  55.                The program was compiled using Turbo Pascal* 5.5, and has local
  56.                symbol information and debug information turned on as well as
  57.                stack and range checking and math coprocessor use and emulation,
  58.                all conspiring to make it a bulky file.  This will be remedied
  59.                in the final version, allowing larger map and table files, etc.
  60.  
  61.                The program is very heavily slanted towards the object-oriented
  62.                paradigm.  Without TP5.5 I doubt I could have had this ready by
  63.                now.  Even with OO, it's a fairly complex project, totalling, at
  64.                last count, over 12,000 lines of source code.  I am pleased that
  65.                a lot of the object classes I made for this program could be
  66.                (and have been) generalized to make very useful tools for use in
  67.                any kind of software.  These will definitely turn up over and
  68.                over again in my future programs.  Many other objects and
  69.                routines I developed in connection with other projects, but they
  70.                came in very handy when writing Synthe/Zap!
  71.  
  72. SZ.PAS         Turbo Pascal 5.5 source code for the top level only of the
  73.                instrument editor.  To actually use this you would need to have
  74.                the JSys-3 package, which contains all the general-purpose
  75.                toolbox units used in this program.  If you like the compact,
  76.                powerful programming style these heavy-duty routines make
  77.                possible, contact me for details on becoming a member of the
  78.                JSys-3 Development Team.  Generally revised each release.
  79.  
  80. SYNZAP10.TXT   Some documentation on the operation of the Synthe/Zap! program.
  81.                ASCII text file with some IBM gracphics characters; formatted
  82.                for printing (79 characters wide, so use 12 cpi if possible;
  83.                just type COPY SYNZAP10.TXT LPT1: at the DOS command prompt).
  84.                Present in the first release, this file will be much expanded
  85.                in future releases and additional documents will be added.
  86.  
  87. TRIPMUSI.CHR   A BGI stroked font, based on the Triplex font provided with
  88.                Borland's BGI Toolkit, but with some high-order characters
  89.                replaced by music symbols.  This file must be in the same
  90.                disk directory you are running the program from (ordinarily the
  91.                same one that holds the program itself).  This font includes all
  92.                the notes, staff, clefs, and other musical notation used in the
  93.                program, as well as others to be used in the sequencer program,
  94.                Synthe/Seq!, which I will be working on next.  The program will
  95.                operate without this file, but the display will be mangled and
  96.                you will not be able to use it easily.  This font file is for
  97.                use ONLY as part of the Synthe/Zap! package.  Present in first
  98.                release, albeit not quite in its finished form (but all of the
  99.                characters used by Synthe/Zap! are perfect).
  100.  
  101. EGAVGA.BGI     Borland's BGI graphics driver file for EGA and VGA displays.
  102.                This file must be in the same disk directory you are running the
  103.                program from (ordinarily the same one that holds the program
  104.                itself), or the program will not be able to operate at all.  For
  105.                use ONLY as part of the Synthe/Zap! package.  Present in first
  106.                release.
  107.  
  108. ───────────────────────────────────────────────────────────────────────────────
  109.  
  110.                                ╓────────────╖
  111.                                ║ IMPORTANT! ║
  112. ╓──────────────────────────────╨────────────╨────────────────────────────────╖
  113. ║       The Synthe/Zap! program, all associated files (except Borland's      ║
  114. ║   BGI driver file), and all elements of the JSys-3 User Interface are  ║
  115. ║              Copyright (C) 1990 by J Meeks & Machina Sapiens!              ║
  116. ╙────────────────────────────────────────────────────────────────────────────╜
  117.  
  118. This software is the copyrighted intellectual property of J Meeks and Machina
  119. Sapiens; I am distributing it as shareware.  This does not mean that it is
  120. free; it means that you have a limited right to try the program and decide if
  121. it fits your needs.  If you decide to use it, please pay for it.  Send your
  122. registration fee of $22.50 (check or money order) to:
  123.  
  124.      J Meeks / Machina Sapiens
  125.      3808 Greenbay Rd. #3
  126.      Richmond, VA  23234
  127.  
  128. and I will send you the latest version of the fully-featured program.  The
  129. program in this package is a demonstration with all the capabilities of the
  130. full version except the save-an-instrument function.  You can use it to exper-
  131. iment with sounds, loading old ones to alter or creating new ones from scratch.
  132. You can also play simple tunes using the mouse and the test play staff.  But to
  133. save your audio creations, you will need the registered shareware copy.
  134.  
  135. I've made every effort to ensure that the software runs correctly and performs
  136. its intended function.  However, the variations in computer systems and the
  137. uncontrolled nature of the uses to which they are put forces me (like virtually
  138. every other programmer in the known world) to make the following tedious and
  139. horribly familiar-sounding disclaimer:
  140.  
  141.     Machina Sapiens, its parent company, Intellectronics, and the author,
  142.     J Meeks make no warranties, either express or implied, concerning the
  143.     suitability of this software for a particular application.  Under no
  144.     circumstances shall Machina Sapiens, Intellectronics, or J Meeks be
  145.     held accountable for any damages resulting to a computer system due
  146.     to the use or operation of this software package; this includes but
  147.     is not limited to damage to equipment, storage media, and programs and
  148.     data files, as well as loss of data, time and business resulting from
  149.     such damage.
  150.  
  151. Of course, if your copy does not run as it should, PLEASE let me know so I can
  152. make it run correctly!  I will need to know exact details concerning both your
  153. hardware (computer, CPU, clock speed, amount of RAM, disk drives, display type,
  154. monitor type, mouse type, etc.) and your software (what's in your AUTOEXEC.BAT
  155. and CONFIG.SYS files, what other memory-resident programs you use, what version
  156. of the Ad Lib sound driver you're using, of course what version of Synthe/Zap!
  157. you have, and so on).  I want this program to run on every PC compatible that
  158. has an EGA or VGA with enough RAM and a matching monitor, a Microsoft compat-
  159. ible mouse, and an Ad Lib synthesizer.
  160.  
  161. FREE distribution of this demo package is welcome, as long as ALL THE FILES are
  162. distributed unchanged, and no files are added or removed.  Bulletin Board
  163. Sysops are welcome to convert the archive format into their local favorite
  164. (Arc, Zip, Pak, Zoo, LHArc, etc.), as long as none of the contents are deleted
  165. or modified, no files are added, and NO ARCHIVE OR FILE COMMENTS ARE ADDED!
  166.  
  167. IT IS EXPRESSLY FORBIDDEN TO CHARGE ANY FEE OR PRICE for this software, nor for
  168. media containing the software, nor for the service of providing it!  This means
  169. that shareware/freeware libraries who pack disks with programs and sell the
  170. disks MAY NOT PUT THIS SOFTWARE ON THEIR DISKS FOR SALE!
  171.  
  172. I plan to make more software for the Ad Lib music synthesizer, as well as
  173. programs for MIDI, and I want to make them generally available.  If there's no
  174. problem with unauthorized distribution, then we will all be the beneficiaries.
  175. Thanks!
  176.  
  177. ───────────────────────────────────────────────────────────────────────────────
  178.  
  179. Release History
  180.  
  181. Release 1.00 -- First beta test -- 04-15-90
  182. First properly functioning version incorporating shareware notice.  All
  183. previous versions were for my own use only.
  184.  
  185. ───────────────────────────────────────────────────────────────────────────────
  186.  
  187. Coming Attractions
  188.  
  189. I plan to add the following features in upcoming releases:
  190.  
  191. Much improved documentation, including a complete tutorial on FM and additive
  192. synthesis.  There will be a full set of instrument files demonstrating exactly
  193. what effects different control settings have on the sound produced.
  194.  
  195. Two more boxes displaying graphically what the envelope settings you have
  196. selected for the Modulator and the Carrier (Attack Rate, Decay Rate, Sustain
  197. Level, Sustain Sound On/Off, and Release Rate) will 'look' like.  This will
  198. help those not as familiar with the ADSR envelope generator to visualize the
  199. timbre that will result, be it staccato or bowed, dramatic or subtle.
  200.  
  201. The ability to load instruments from, and/or save them to, bank (.BNK) files as
  202. well as the presently supported instrument (.INS) files.  This will include a
  203. friendlier alternative to the bank managing software that Ad Lib provides.
  204.  
  205. With the bank file interface will come the choice of a waveform for the Modu-
  206. lator and one for the Carrier.  You can select from the usual sine wave; a wave
  207. having positive half-cycles only (sounds sort of like a rectangle wave); a
  208. full-wave rectified sine wave (a bit like a triangle wave); or full-wave rect-
  209. ified with the second half of each cycle chopped out (sounds sort of like a
  210. sawtooth wave).
  211.  
  212. Scrollable pick lists for file names (or in the case of bank files, instrument
  213. names) so you can just pick and shoot, instead of having to remember all those
  214. cryptic filenames (and you will likely make a LOT of instruments).
  215.  
  216. Some sort of support for playing a music (.ROL) file from within the program,
  217. checking first to be sure that piece includes the instrument you are working
  218. on.  Also possibly a very simple construction kit-type sequencer.
  219.  
  220. Help screens telling exactly how to use the program.  This is very nearly
  221. superfluous, as the fell of the program is so much like a real analog synth
  222. that it is almost automatic.  Still, for completeness it ought to be there, and
  223. context-sensitive to boot.  Sigh.
  224.  
  225. An Association of Shareware Professionals notice and logo!  I plan to join as
  226. soon as I find where to send my dues.  I think this program is good enough for
  227. me to make the big jump.
  228.  
  229. Whatever else you suggest that strikes me as useful or desirable, or that
  230. catches some obscure corner of my imagination...
  231.  
  232. ───────────────────────────────────────────────────────────────────────────────
  233.  
  234. * Trademark notices
  235.  
  236. Machina Sapiens, Synthe/Zap!, Synthe/Seq!, and JSys-3 are trademarks of Machina
  237. Sapiens and J Meeks.  Intellectronics is a trademark of Intellectronics and J
  238. Meeks.
  239.  
  240. Ad Lib, Ad Lib Personal Computer Music System, Ad Lib Music Synthesizer Card
  241. (ALMSC), Ad Lib Instrument Maker, and Ad Lib Visual Composer are trademarks of
  242. Ad Lib, Inc.
  243.  
  244. Borland and Turbo Pascal are trademarks of Borland International.
  245.  
  246. IBM PC, EGA, VGA, and (for all I know) the shapes of the digits 0 through 9
  247. inclusive are trademarks of International Business Machines Corp.
  248.  
  249. ───────────────────────────────────────────────────────────────────────────────
  250.  
  251. Well, there it is.  Play around with it, take a look at the top-level source
  252. code if you like, and PLEASE tell me what you think.  I really appreciate your
  253. input!  If you have any questions or comments please leave me a message on:
  254.  
  255.      Blue Ridge Express BBS      15 lines, 300/1200/2400 bps,
  256.      Chesterfield, VA            8 data bits, no parity, 1 stop bit.
  257.      (804) 790-1675              Free call from Richmond area.
  258.  
  259. You can leave messages in the Program conference (sub-board), of which I am a
  260. member, the MIDI conference, the Hobbies conference, where I'm sub-Sysop, or
  261. in the Main area.
  262.  
  263. I'm also available on CompuServe, though I can't afford to check in as often
  264. as I'd like to.  My user number is 72711,257 if you want to EMail me there.
  265. The best place to contact me concerning this and other music software is the
  266. IBMNEW forum, in the MUSIC message area.
  267.  
  268. Alternatively, you can mail me a letter, disk, etc. at the same address you
  269. use to send your shareware registration fee:
  270.  
  271.      J Meeks / Machina Sapiens
  272.      3808 Greenbay Rd. #3
  273.      Richmond, VA  23234
  274.  
  275. ...and hope it arrives before the next major glacial epoch...
  276.  
  277. ╓────────────────────────────────────────────────────────────────────────────╖
  278. ║ ■■        Enjoy the software, and don't forget to ROCK 'n' ROLL!        ■■ ║
  279. ╙────────────────────────────────────────────────────────────────────────────╜